home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / EVENT21.ARJ / EVENT.DOC next >
Text File  |  1991-01-10  |  42KB  |  693 lines

  1. ┌──────────────────────────────────────────────────────────────────────────────┐
  2. │              ┌──────┐  ┌─┐ ┌─┐ ┌──────┐  ┌───┐  ┌─┐  ┌───────┐               │
  3. │              │  ┌───┘  │ │ │ │ │  ┌───┘  │ ┌┐└┐ │ │  └──┐ ┌──┘               │
  4. │              │  └─┐    │ │ │ │ │  └─┐    │ │└┐└┐│ │     │ │                  │
  5. │              │  ┌─┘    │ │ │ │ │  ┌─┘    │ │ └┐└┘ │     │ │                  │
  6. │              │  │      └┐└─┘┌┘ │  │      │ │  └┐  │     │ │                  │
  7. │              │  └───┐   └┐ ┌┘  │  └───┐  │ │   └┐ │     │ │                  │
  8. │              └──────┘    └─┘   └──────┘  └─┘    └─┘     └─┘                  │
  9. │                        ┌────────┐     ┌─┐                                    │
  10. │                        └──────┐ │     │ │                                    │
  11. │                               │ │     │ │                                    │
  12. │                        ┌──────┘ │     │ │                                    │
  13. │                        │ ┌──────┘     │ │                                    │
  14. │                        │ │            │ │                                    │
  15. │                        │ └──────┐ ┌┐  │ │                                    │
  16. │                        └────────┘ └┘  └─┘                                    │
  17. │                                                                              │
  18. │                    EVENT -- The DOS Scheduler Ver 2.1                        │
  19. │                                                                              │
  20. │               EVENT(C). John Wagner 1990,91. All rights reserved             │
  21. │                                                                              │
  22. └──────────────────────────────────────────────────────────────────────────────┘
  23.  
  24. For information on what is new for Ver 2.1, see the text file WHATS.NEW.
  25.  
  26.  
  27. (R)=Registered Users Only
  28. (U)=Un-Registered Users Only
  29.  
  30.                              Legal Mumbo-Jumbo:
  31. ┌──────────────────────────────────────────────────────────────────────────────┐
  32. │ For the sake of argument, the EVENT.EXE, UP_DATE.EXE, REG.KEY, UNREG.KEY and │
  33. │ EVENT.DOC may (and will) be referred to by the terms: EVENT, the program,    │
  34. │ the software.                                                                │
  35. │                                                                              │
  36. │ I, John M. Wagner retain ALL rights to distribute and collect fees for this  │
  37. │ software. This software IS NOT RELEASED TO THE PUBLIC DOMAIN!!! IT IS NOT    │
  38. │ FREE!!! It is OWNED by me and only me!                                       │
  39. │ You, as a user have the right to possess and distribute this software. You   │
  40. │ MAY NOT collect ANY FEE, real or otherwise for the transfer of this          │
  41. │ software, Exception: You may charge the cost of distribution (ie: phone      │
  42. │ transfer costs, floppy disk/mailers, postage. It is to be understood, with   │
  43. │ the party that is charged these fees, that paying transfer costs DOES NOT    │
  44. │ constitute a registration fee to the author and that a registration fee is   │
  45. │ STILL required after evaluating the software.                                │
  46. │                                                                              │
  47. │ DISCLAIMER NOTICE:                                                           │
  48. │ This program was written by John Wagner. I, John Wagner accept               │
  49. │ NO RESPONSIBILITY for ANY damages, real or otherwise that this program       │
  50. │ or any programs that it runs may cause. I make no guarantees that this       │
  51. │ program works as described in this document file or anywhere else. This      │
  52. │ software is provided "AS IS" with NO GUARANTEE, expressed or implied.        │
  53. │ USE IT AT YOUR OWN RISK!                                                     │
  54. └──────────────────────────────────────────────────────────────────────────────┘
  55.  
  56. User Supported Software:
  57. (U)This program is being distributed as "User-Supported Software". What
  58. does this mean? This means that you may TRY the program before you BUY
  59. it. This DOES NOT mean this software is free. You can see the program
  60. run and evaluate its use to you, before you pay for it.
  61.  
  62. (U)Often the question arises as to what constitutes "TRYING" a program.
  63. For the purpose of THIS SOFTWARE, TRYING means that you may use the
  64. program 10 TIMES. After you use the software 10 TIMES, you will know if
  65. you want to continue using the program or not. If you don't want to use
  66. the program anymore, delete all copies you have of the software and
  67. discontinue USING it. If you decide to keep using the program you must
  68. send in your registration fee.
  69.  
  70. (U)Registering EVENT:
  71. Registration is $20 per copy, for the first 5 copies. Additional copies
  72. after the initial 5 are $5 per copy. A site license is negotiable.
  73. Payment is accepted by check (allow 4 to 6 weeks to clear) or money
  74. order only. NY state residents must add 7% sales tax. Make all checks
  75. and money orders payable to: John Wagner. Specify 360k or 1.44 meg (add
  76. 1 dollar for 1.44) format. (If you don't I will send you 360k)
  77.  
  78. Update by Mail Plan:
  79. For an additional $7 per copy, I will send you the next 5 releases of
  80. the program as they become available ($12 per copy for 1.44 meg). You
  81. may apply this plan to as many (or as few) copies as you wish.
  82.  
  83.                                 HOW TO ORDER:
  84. ┌──────────────────────────────────────────────────────────────────────────────┐
  85. │ Include the following information in your order:                             │
  86. │ How many copies?                                                             │
  87. │ Disk format?                                                                 │
  88. │ Shipping address?                                                            │
  89. │ Amount enclosed?                                                             │
  90. │ Update by mail plan?                                                         │
  91. │ Special Requests?                                                            │
  92. │                                                                              │
  93. │ Mail your order and payment to:   John Wagner                                │
  94. │                                   RR1 157 Box M                              │
  95. │                                   Taberg, NY 13471                           │
  96. │                                                                              │
  97. │ Order MUST INCLUDE payment in FULL, NO COD's. Money orders and Checks        │
  98. │ ONLY. Do not send cash.                                                      │
  99. │                                                                              │
  100. └──────────────────────────────────────────────────────────────────────────────┘
  101.  
  102. (U)Within 2 to 4 weeks you will receive your disk(s) with the latest
  103. version of EVENT and a personalized REG.KEY file. If later versions of
  104. the software are released, they will be posted on KADET BBS (see end of
  105. DOC file). You can simply call KADET and download the latest version,
  106. and use your REG.KEY file with the new program. What this means in
  107. laymens terms is: ONCE A REGISTERED USER, ALWAYS A REGISTERED USER!
  108.  
  109. You have received the latest version of the EVENT program on this disk.
  110. (R)You have also received your own personalized "REG.KEY" file.
  111.  
  112. (R)Please do not distribute your "REG.KEY" file. Doing so would violate
  113. the terms of your license and violate the copyright I have on the
  114. program.
  115.  
  116. (U,R)WARNING!:
  117. DO NOT MODIFY THE REG.KEY FILE IN ANY WAY! Doing so might (read: most
  118. probably will) make the file useless. If it's your only copy, your out
  119. of luck! I hereby give permission for you to make 2 copies of the
  120. "REG.KEY" file. 1 for back up and 1 for archival purposes.
  121.  
  122. What is EVENT?:
  123. EVENT is a simple to use, but very powerful program. EVENT allows up to
  124. twelve different system events to be pre-programmed and processed at
  125. specified times. You may also chain event files together to allow an
  126. infinite number of events to be pre-programmed.
  127.  
  128. Why is EVENT?:
  129. I wrote this program for me. To increase the life of your hardware, it
  130. is now recommended that you leave your system on at all times. This is
  131. to prevent the wear and tear from turning your system on and off. So,
  132. all the time my system is running unattended, it should be doing some
  133. work! It would be a real waste to have it just sit there. Henceforth:
  134. EVENT. Why should I waste MY time just watching my computer while it
  135. does things like run a comm program with a script file that gets my
  136. mail. Optimizing a hard disk is great, but not a very interactive
  137. process and I don't feel I need to watch it! There are many reasons for
  138. running this program. Even if you don't use it all the time (I do),
  139. there will be a lot of times when it will come in handy.
  140.  
  141. What can it do?
  142. I think it would be better put: What cant it do! I have yet to find a
  143. program that cannot be run under EVENT. If your program requires you to
  144. physically enter key strokes, this can USUALLY be overcome using DOS's
  145. indirection operators. A full explanation of indirection and DOS is not
  146. in the scope of this DOC, if need information on these subjects, consult
  147. your DOS manual. The uses of this program are endless: E-Mail transfers,
  148. system backups and other daily events are just a minute inkling of what
  149. you can pre-set your computer to do. If a program can be run from a
  150. batch file, it can be run from EVENT. Run time consuming programs,
  151. programs that require you to just sit there and watch, disk compression
  152. programs, compile large files, WHATEVER!
  153.  
  154. You could set up your system to call a distant Bulletin Board Service
  155. (BBS) to transfer mail during the reduced phone rate time periods. The
  156. savings will start to show immediately.
  157.  
  158. Backup critical system files during the night. After everyone has gone
  159. home from work, let the computer keep on working! Going on a trip? Use
  160. this program to bring up your communications software at specified times
  161. so that it can receive your call. With a little imagination this program
  162. can become one of your most valuable tools. Use the CHAIN_EVENTS and
  163. UP_DATE features and program your system for years in advance! I've let
  164. my system run on it's own and collect mail for me for the past four
  165. months. Using this program increases productivity. It allows you more
  166. time to do actual work, and that is the bottom line.
  167.  
  168. Power Outage?:
  169. EVENT automatically tracks what it has done up to the time the program
  170. was shut off. Use the AUTO RECOVER feature to bring up EVENT and
  171. continue where it left off in the event of a power outage. The EVENT
  172. program keeps a log of what was accomplished in a file with the same
  173. name as your EVENT file except with the extension .LOG. To view the .LOG
  174. file, use the built in LOG file viewer. See the section near the end of
  175. this DOC file called: "Recovering from a power outage:" for more
  176. information on recovering from a power outage while running EVENT.
  177.  
  178. Use EVENT with DESQview: The DESQview environment is ideal for EVENT.
  179. Run the program in the background while you are still working!
  180.  
  181. EVENT allows large programs to run:
  182. When EVENT shells out to run a program, it can be configured to load
  183. itself into Extended memory or Expanded memory or a Disk Drive. This
  184. swapping is optional and configurable and is highly desirable. When it
  185. swaps out, EVENT uses 6K of RAM, the rest is free to run the program the
  186. EVENT calls.
  187.  
  188. SWAP FILES:
  189. If your configuration allows for swapping and EVENT finds no XMS or EMS
  190. to swap itself out to, it will try to use a swap file on disk. Where
  191. EVENT places it's SWAP FILE is up to you. You specify the SWAP FILE
  192. drive/directory in your EVENT.CFG file. If none is specified in your
  193. EVENT.CFG file, it will use the root directory of the disk drive the
  194. program is running on. The SWAP FILE will be hidden. The SWAP FILE will
  195. be erased as soon as the program returns from it's shell. The SWAP FILE
  196. is about 133K long so be sure there will be space on the drive/directory
  197. you specify. Also be sure the drive you specify is not write protected.
  198. (IMPORTANT!)
  199.  
  200. System Configuration:           IMPORTANT!!!
  201. ┌──────────────────────────────────────────────────────────────────────────────┐
  202. │ Make a sub-directory called EVENT. Copy all the files on this disk into      │
  203. │ the directory you created.                                                   │
  204. │                                                                              │
  205. │ Use your Hard Drive:                                                         │
  206. │ EVENT may be run from a floppy but I don't recommend it. The COMSPEC         │
  207. │ variable is used to locate a copy of COMMAND.COM to invoke a shell when      │
  208. │ running an EVENT or using an external editor or using the DOS-SHELL. If you  │
  209. │ run off a floppy and EVENT can not locate COMMAND.COM, the operation will    │
  210. │ fail. It can also be configured to place it's swap file on a floppy, but     │
  211. │ again, I don't recommend it. It's not harmful, it's slow.                    │
  212. │                                                                              │
  213. │ There is a section at the end of this DOC file containing RECOMMENDED setups │
  214. │ for all system configurations.                                               │
  215. └──────────────────────────────────────────────────────────────────────────────┘
  216.  
  217.  
  218.                         ┌──────────────────────────┐
  219.                         │ HOW DO I RUN THIS THING? │
  220.                         └──────────────────────────┘
  221. Running the program:
  222. From the DOS command line, the programs usage is as follows:
  223.  
  224.                ┌───────────────────────────────────────────┐
  225.                │                   USAGE:                  │
  226.                │        EVENT                              │
  227.                │   -or- EVENT n                            │
  228.                │                                           │
  229.                │ WHERE: n = filename of EVENT file to run. │
  230.                └───────────────────────────────────────────┘
  231.  
  232. Menuing System:
  233. The menu system is a standard pull down menu interface. Use the arrow
  234. keys to move the selection bar (RED) to the option you want and press
  235. Return. If you have a mouse you may use it to point at the option you
  236. want and click on it (point and shoot) with the Left Mouse Button (LMB).
  237. To close a pull down menu press the Escape key or click the Right Mouse
  238. Button (RMB).
  239.  
  240. Pickfile Window:
  241. When given the option of entering a filename (.EVT or .BAT), pressing
  242. Alt-D will bring up a "Pickfile Window" with all the existing files in
  243. the current directory with the matching extension for the operation
  244. (*.BAT or *.BAT). The window will also have all sub-directories in it.
  245. If there are no files that match the search criteria the Pickfile window
  246. will automatically return to the text entering function. Use the arrow
  247. keys, Page Up, Page Down, Home or End keys to move the selection bar
  248. (RED) to the file you wish to load and press the Enter key. If you
  249. select a sub-directory, the program will change to the directory you
  250. selected and the process will start all over again until you either pick
  251. a file or press the Escape (Esc) key or click the mouse on the Close
  252. Box. After a file is selected, it's name will be shown on the edit line
  253. just as if you typed it in. Pressing Enter again will bring up the
  254. proper editor for the operation. If you are using a mouse, point and
  255. shoot (LMB) at the filename/sub-directory you wish to select. The RMB is
  256. the same as pressing the Escape key. Sample Pick File Window:
  257.  
  258.                              Title Bar displays filespec
  259. Close Box                    ──────┬────────────────────
  260. ────┬────                          │
  261.     │   ┌────┬─────────────────────────────────────────────┐
  262.     └───│ ── │            C:\EVENT\*.EVT                   │
  263.         ├────┴─────────────────────────────────────────────┤
  264.         │ .             ..            TEST.EVT    NEW.EVT  │
  265.         │                                                  │
  266.         │ MORNING.EVT   EVENING.EVT   COMPRES.EVT          │
  267.         │                                                  │
  268.         │                                                  │
  269.         └──────────────────────────────────────────────────┘
  270.  
  271.  
  272. Mouse Users:
  273. The mouse is fully supported in EVENT. In menu operations it functions
  274. as a "Point and Shoot" device and during editor (internal) operations,
  275. rolling the mouse is the same as using the arrow keys. The LMB is
  276. functionally the same as the Enter key and the RMB is functionally the
  277. same as the Escape key.
  278.  
  279. The following options are available from the Main Menu:
  280.  
  281.                           INFO, FILE, OS-SHELL or EXIT
  282.  
  283. INFO gives a quick overview of the program.
  284.  
  285. FILE gives you the option of either, Loading an EVENT File, Editing the
  286. EVENT File in Memory, Running the EVENT File in Memory, Using the Batch
  287. file editor or editing (or creating) the Configuration file (EVENT.CFG).
  288.  
  289. Loading an EVENT File:
  290.  
  291. Editing an EVENT file:
  292. After loading an EVENT file, you will be placed in the EVENT editor. If
  293. you have an EVENT already loaded and select EDIT from the Main Menu you
  294. will use the same editor. Table 1.1 outlines the editors commands.
  295.  
  296. Table 1.1:
  297. ┌──────────────────────────────────────────────────────────────────────────────┐
  298. │                                                                              │
  299. │         Key                  Action                                          │
  300. │         ---                  ------                                          │
  301. │       LeftArrow             cursor left                                      │
  302. │       RightArrow            cursor right                                     │
  303. │       UpArrow               cursor up                                        │
  304. │       DownArrow             cursor down                                      │
  305. │       Ctrl-LeftArrow        word left                                        │
  306. │       Ctrl-RightArrow       word right                                       │
  307. │       Tab                   field right                                      │
  308. │       Shift-Tab             field left                                       │
  309. │       Enter                 process field                                    │
  310. │       Ctrl-Enter            process all fields                               │
  311. │       Home                  beginning of field                               │
  312. │       End                   end of field line / end of field                 │
  313. │       Ctrl-Home             beginning of first field                         │
  314. │       Ctrl-End              end of last field                                │
  315. │       Ins                   toggle field insert mode                         │
  316. │       Del                   delete character at cursor                       │
  317. │       BackSpace             delete character left                            │
  318. │       Ctrl-BackSpace        delete word left                                 │
  319. │       Ctrl-R                restore field to original contents               │
  320. │       Ctrl-T                delete word right                                │
  321. │       Ctrl-U                delete to end of field                           │
  322. │       Ctrl-Y                delete to end of last field                      │
  323. │       Esc                   abort data entry                                 │
  324. └──────────────────────────────────────────────────────────────────────────────┘
  325.  
  326. DATE:
  327. Enter the date in the format MM/DD/YY. If you want to automatically
  328. enter the system date, move the cursor to the first column (left most)
  329. of the date field and press ALT-D.
  330.  
  331. TIME:
  332. Enter the Time in military (24 hour) time format: (e.g., 23:00. would
  333. equal 11 p.m.) If you want the EVENT to execute immediately, don't enter
  334. a time.
  335.  
  336. EVENT:
  337. Enter the Event you want to run. Enter it just as you would on the DOS
  338. command line. If your event includes more than one command, write a
  339. batch file to include all of the commands and specify the name of the
  340. batch file on the Event line. EVENT will search the PATH environment
  341. variable to find a program. If the program you want to run resides in a
  342. directory other than the directory EVENT is in, you may specify it's
  343. path or write a batch file that changes to the correct directory/drive
  344. to run the program if it doesn't reside in a directory specified by your
  345. PATH statement. EVENT switches back to the directory/drive that the
  346. EVENT program was started from so changing the directory as one EVENT
  347. and running the program as another will not work. Always make sure the
  348. program you run exits to DOS when it is finished.
  349.  
  350. Chaining Events:
  351. This program can also be used to load a subsequent event(s) file.  To
  352. have it do so, enter the command "CHAIN_EVENTS" and the name (no
  353. extension needed) of the subsequent event file.  For example, to
  354. discontinue the event that is currently loaded and start processing
  355. another event called DATABACK which (must be created before you try to
  356. run it!), type "CHAIN_EVENTS DATABACK" in the event field.
  357.  
  358. IMPORTANT: After EVENT reaches a CHAIN_EVENTS event, the calling event
  359. file will be closed and any events programmed after the CHAIN_EVENTS
  360. command will not be processed. If you wish to chain more event files,
  361. you must call CHAIN_EVENTS from the file you just chained to.
  362.  
  363. UP_DATE:
  364. UP_DATE.EXE provides an alternative to writing a different EVENT file
  365. for EVENTS that will be run as daily events. With UP_DATE you can run
  366. the same EVENT for many days (or years) without having to re-edit it or
  367. CHAIN_EVENTS to an EVENT file that only changes the date.
  368.  
  369.   UP_DATE.EXE:  ┌────────────────────────────────────────────────┐
  370.                 │ USAGE: UP_DATE n                               │
  371.                 │                                                │
  372.                 │       WHERE: n = name of EVENT file to update. │
  373.                 └────────────────────────────────────────────────┘
  374.  
  375.  UP_DATE will increment the date field in the event file specified by 1.
  376.  If UP_DATE is run on the current EVENT file, the changes will not take
  377.  effect until the EVENT is reloaded with CHAIN_EVENTS. Leap Year? Not to
  378.  worry, I remembered to put it in!
  379.  
  380.  Example event file called BACKER.EVT:
  381. ┌──────────────────────────────────────────────────┐
  382. │DATE     TIME   EVENT                             │
  383. │10/02/90 10:10  COPY D:\WKS\*.WKS A:              │
  384. │10/02/90 12:00  C:\COMM\QMODEM\MAILRUN.BAT        │
  385. │10/02/90 12:10  COPY C:\XFER\*.QWK D:\MAIL        │
  386. │10/02/90 13:05  UP_DATE BACKER                    │ Increment dates
  387. │10/02/90 13:10  CHAIN_EVENTS BACKER               │ Reload EVENT with new dates
  388. │                                                  │
  389. │                If the date field is blank, you   │
  390. │                may use the EVENT field to put    │
  391. │                in comments.                      │
  392. │                                                  │
  393. └──────────────────────────────────────────────────┘
  394.  
  395. When you are through editing your EVENT file, press Ctrl + Enter, the
  396. file will be saved to disk. To abort the entries press ESC.
  397.  
  398. Running an Event:
  399. After either creating or loading an Event file, you are ready to RUN!
  400. Select this option and let the program do the rest!   The program will
  401. run even after the last event was processed. Pressing the ESC key during
  402. the EVENT processing will stop the EVENT and display a report of what
  403. has been done prior to halting. Pressing the space bar will toggle the
  404. screen display on and off.
  405.  
  406. Batch file editor:
  407. The batch file editor included in this program is very simple and NOT
  408. designed nor intended for serious programming use. It is included as an
  409. extra tool for batch programming and is very limited in capabilities.
  410. Only 23 lines of 80 characters per line are allowed. As an alternative
  411. to the internal batch file editor, you may specify an external editor to
  412. use when this option is selected. See the section on Configuration for
  413. setting up an External Editor.
  414.  
  415. Select Batch Editor from the FILE menu. If any BATCH files (*.BAT) exist
  416. or you are in a sub-directory you will see a pickfile window. Otherwise
  417. you will be prompted to enter a filename. Enter the name you want to
  418. give the BATCH File (or the name of an existing BATCH file) or press
  419. Alt-D to bring up a pickfile window or hit the ESC key to abandon this
  420. operation. After selecting a file, either from the pickfile window or
  421. typing one in, press the ENTER key. If the filename you specify does not
  422. exist, you will be asked if you want to create it. You may enter an
  423. extension, but the program will automatically substitute it with a .BAT
  424. extension.
  425.  
  426. Configuration File:
  427. EVENT saves it's configuration by modifying EVENT.EXE with parameters
  428. you supply. If you use a program such as PKLITE, or LZEXE to compress
  429. the EVENT.EXE file, and then try to alter the programs configuration, an
  430. error will occur. Always alter the configuration on a fully expanded
  431. version of the program, and then compress it when you are satisfied with
  432. the configuration.
  433.  
  434.         Here are the Configuration options:
  435.  
  436.           Path to External Editor:
  437.           Enter in the drive/path that your external editor resides on/in.
  438.           If don't have one or don't want to use one, just leave the field
  439.           blank. Example:
  440.  
  441.                To use the QEDIT editor in the C:\EDIT directory,
  442.                           enter: C:\EDIT\Q
  443.  
  444.           Path to SWAP directory:
  445.           Enter in the drive/path that you want EVENT to place it's
  446.           SWAP FILE if it is needed. If you leave the field blank,
  447.           the program will use your root directory. Don't despair,
  448.           the SWAP FILE gets erased when the program is done using it!
  449.           Example:
  450.  
  451.                To use the C:\WINDOWS\TEMP directory,
  452.                           enter: C:\WINDOWS\TEMP
  453.  
  454.           Allow swap when using editor:
  455.           Allow swap when running EVENT:
  456.           Allow swap when in DOS SHELL:
  457.           These are all yes (Y) or no (N) answers. What this means is do
  458.           you want the program to swap itself out XMS, EMS or disk when
  459.           shelling during the operation specified. I recommend answering
  460.           yes (Y) to all of the above to allow the program you are going to
  461.           run as much memory as possible while it is running. You might
  462.           have a very valid reason not to do this so the option is yours.
  463.  
  464.           Use External Editor:
  465.           If no external editor is specified or for some reason you do not
  466.           want to use your external editor select no (N). Otherwise select
  467.           yes (Y) to use the external editor while editing batch files.
  468.  
  469. Log Viewer:
  470. Use this to view the files with a .LOG extension that are created by the program
  471. when an EVENT is run. The .LOG file will contain a list of what was done and
  472. the start and stop times.
  473.  
  474. OS-SHELL gives you a shell to DOS. Type EXIT to return to the program.
  475.  
  476. EXIT quits the program and exits you to DOS.
  477.  
  478. Recovering from a power outage:
  479. This is one of EVENT's most powerful features. The program tracks what
  480. EVENT's have not been run yet by keeping a spare EVENT file on disk
  481. called CURRENT.EVT. The CURRENT.EVT file is a standard .EVT file, that
  482. the program updates each time, after it runs an EVENT. It is identical
  483. to the EVENT file that the program is processing EXCEPT it rewrites
  484. itself after every EVENT is run, deleting the EVENT that was just run
  485. after it is done. If there is a power outage, your system will re-boot.
  486. If you place the following lines at the end of your AUTOEXEC.BAT file,
  487. you can restart EVENT where it left off when the power went out and
  488. continue processing! Here is what you need to add to your AUTOEXEC.BAT
  489. file:
  490.  
  491.                         REM Change drives and directories to the
  492.                         REM drive/directory EVENT resides on.
  493.  
  494.                          C:
  495.                          cd\event
  496.                          EVENT CURRENT.EVT
  497.  
  498.                          REM Your system configuration will probably
  499.                          REM differ, so use your configuration,
  500.                          REM not mine!
  501.  
  502. This will start up EVENT and load CURRENT.EVT for immediate execution.
  503. CURRENT.EVT will have all the EVENTS that did not get run from the EVENT
  504. file that was running when the power went out or the system re-booted.
  505. The .LOG file will be changed from the filename of the EVENT file that
  506. was running to CURRENT.LOG. The first .LOG file will still be there for
  507. you to examine.
  508.  
  509. .LOG files:
  510. EVENT creates a file called a .LOG file whenever it runs an EVENT. The
  511. .LOG file will have the same filename as the .EVT file you are running
  512. but it will have a .LOG extension. If you use the CHAIN_EVENTS feature,
  513. the .LOG filename will NOT change to the .EVT filename that was chained
  514. to. It will retain the filename of the "parent" .EVT file. EXCEPTION:
  515. During a power failure when the CURRENT.EVT file is run, CURRENT.LOG
  516. will become the current .LOG file but the "parent" .LOG file will still
  517. be there for examination.
  518.  
  519. Common Problems and Questions:
  520. ┌──────────────────────────────────────────────────────────────────────────────┐
  521. │                                                                              │
  522. │ Question:                                                                    │
  523. │ This "SWAP FILE", swap when using whatever stuff is confusing. Please        │
  524. │ recommend a good setup.                                                      │
  525. │ Answer:                                                                      │
  526. │ For a standard Hard Disk setup, I recommend all swaps be allowed, an external│
  527. │ editor be setup and a temporary directory be set up. I recommend QEDIT for an│
  528. │ external editor and the drive/directory that the .EVT files reside in be used│
  529. │ for the SWAP FILE.                                                           │
  530. │                                                                              │
  531. │ Question:                                                                    │
  532. │ Every time I try to run an EVENT or use my external editor or the DOS-SHELL, │
  533. │ the operation fails or I get error messages.                                 │
  534. │                                                                              │
  535. │ Answer:                                                                      │
  536. │ EVENT needs to locate a copy of COMMAND.COM in order to run the external     │
  537. │ editor, DOS-SHELL and EVENTS. If your COMSPEC environment variable is set    │
  538. │ to a floppy in drive A: and you removed the disk, the program will be        │
  539. │ unable to run properly. Follow the guidelines below for floppy setup.        │
  540. │ ┌────────────────────────────────────────────────────────────────────────┐   │
  541. │ │ Single floppy setup:                                                   │   │
  542. │ │                                                                        │   │
  543. │ │   Contents of drive A: COMMAND.COM                                     │   │
  544. │ │                        EVENT.EXE                                       │   │
  545. │ │                        EVENT.CFG                                       │   │
  546. │ │                        REG.KEY  (or UNREG.KEY)                         │   │
  547. │ │                        Any .EVT files and batch files you need to run  │   │
  548. │ │                                                                        │   │
  549. │ │ Set up your EVENT.CFG file as follows:                                 │   │
  550. │ │     ┌───────────────────────────────────────────────┐                  │   │
  551. │ │     │ Path to External Editor:                      │ Leave Blank      │   │
  552. │ │     │ Path to SWAP directory:                       │ Leave Blank      │   │
  553. │ │     │ Allow swap when using editor:  N              │                  │   │
  554. │ │     │ Allow swap when running EVENT: N              │                  │   │
  555. │ │     │ Allow swap when in DOS SHELL:  N              │                  │   │
  556. │ │     │ Use External Editor:           N              │                  │   │
  557. │ │     └───────────────────────────────────────────────┘                  │   │
  558. │ │       You may allow swaps if you have at least 133K of XMS or EMS.     │   │
  559. │ │                                                                        │   │
  560. │ └────────────────────────────────────────────────────────────────────────┘   │
  561. │ ┌────────────────────────────────────────────────────────────────────────┐   │
  562. │ │ Dual Floppy Setup:                                                     │   │
  563. │ │                                                                        │   │
  564. │ │   Contents of drive A: COMMAND.COM                                     │   │
  565. │ │   Contents of drive B: EVENT.EXE                                       │   │
  566. │ │                        EVENT.CFG                                       │   │
  567. │ │                        REG.KEY  (or UNREG.KEY)                         │   │
  568. │ │                        Any .EVT files and batch files you need to run  │   │
  569. │ │                                                                        │   │
  570. │ │ Set up your EVENT.CFG file as follows:                                 │   │
  571. │ │     ┌───────────────────────────────────────────────┐                  │   │
  572. │ │     │ Path to External Editor:                      │ Leave Blank      │   │
  573. │ │     │ Path to SWAP directory: A:\                   │ Leave Blank      │   │
  574. │ │     │ Allow swap when using editor:  N              │                  │   │
  575. │ │     │ Allow swap when running EVENT: Y              │                  │   │
  576. │ │     │ Allow swap when in DOS SHELL:  Y              │                  │   │
  577. │ │     │ Use External Editor:           N              │                  │   │
  578. │ │     └───────────────────────────────────────────────┘                  │   │
  579. │ │ NOTE: Depending on the size of your A: drive, you could have an        │   │
  580. │ │ external text editor on it and specify it in your EVENT.CFG file.      │   │
  581. │ │ EVENT requires about 133K of free disk space to use for a SWAP FILE    │   │
  582. │ │ if no XMS or EMS is available.                                         │   │
  583. │ └────────────────────────────────────────────────────────────────────────┘   │
  584. │                                                                              │
  585. │ Question:                                                                    │
  586. │ Can I keep working while EVENT is running?                                   │
  587. │ Answer:                                                                      │
  588. │ DOS is NOT a multi-tasking operating system so the apparent answer is NO.    │
  589. │ HOWEVER, combine EVENT with a DOS multitasker like DESQview or Windows       │
  590. │ and the answer becomes, YES, YES, YES. I must say that EVENT runs better     │
  591. │ under DESQview then Windows, (I think DESQview is a better program anyway)   │
  592. │ but it does run under either.                                                │
  593. │                                                                              │
  594. │ Question:                                                                    │
  595. │ Is EVENT a Terminate Stay Resident (TSR) Program?                            │
  596. │ Answer:                                                                      │
  597. │ Not in the truest sense. EVENT does terminate and stay resident when         │
  598. │ running a DOS-SHELL, External Editor and EVENT's but it does so              │
  599. │ differently from a true TSR. It invokes a secondary command processor,       │
  600. │ it does not leave itself in memory after exiting the program.                │
  601. │                                                                              │
  602. │ Question:                                                                    │
  603. │ Is it safe to run a program like PC-TOOLS COMPRESS or Nortons SPEED DISK?    │
  604. │ Answer:                                                                      │
  605. │ Yes!                                                                         │
  606. │                                                                              │
  607. │ EVENT is not infalable, it can be crashed. Using some common sense however   │
  608. │ will prevent this from happening to you. Below is a list of things NOT TO    │
  609. │ DO!                                                                          │
  610. │                                                                              │
  611. │ DO NOT run Terminate Stay Resident Programs from under an EVENT or from the  │
  612. │ DOS-SHELL. Doing so WILL cause the program to crash.                         │
  613. │                                                                              │
  614. │ Use caution running more than one copy of the program at a time under        │
  615. │ a DOS multitasker. Doing so might (will) erase the other copies SWAP FILE,   │
  616. │ CURRENT.EVT and .LOG files (if it is the same). A work around for this would │
  617. │ be to change the second (and every copy after it) programs swap directory to │
  618. │ something other than the first copies. If you are going to attempt this, I   │
  619. │ suggest using two entirely different copies of the program in separate       │
  620. │ directories with separate EVENT.CFG files that have differing swap file      │
  621. │ directories.                                                                 │
  622. │                                                                              │
  623. │ DO NOT run a program that re-boots the computer, doing so would keep         │
  624. │ EVENT from re-loading itself. It would also leave a HIDDEN SWAP FILE on the  │
  625. │ Hard Disk if one was used. This is not that bad as the SWAP FILE would be    │
  626. │ erased the next time the program is run.                                     │
  627. │                                                                              │
  628. │ DO NOT run EVENT from a write-protected disk. To do so would cause errors    │
  629. │ when saving files and attempting to write the EVENT.LOG and CURRENT.EVT      │
  630. │ files while running an EVENT.                                                │
  631. │                                                                              │
  632. │ Every attempt has been made to ensure smooth operation. Use your head, the   │
  633. │ EVENT program is not infalable, with a little imagination, it can be         │
  634. │ crashed. Then again, so can just about any program!                          │
  635. └──────────────────────────────────────────────────────────────────────────────┘
  636.  
  637. MegaMail is a Trademark and Copyright of Kip Compton. Qmodem is a
  638. Copyright of the Forbin Project. QEDIT is a Copyright of SemWare.
  639. DESQview is a Copyright of Quarterdeck. Windows is a Copyright and
  640. Trademark of Microsoft. None of the programs is in any way associated
  641. with EVENT or John Wagner.
  642.  
  643. A sample BATCH file that will get (call) KADET.BBS and xfer my MegaMail.
  644. Comments follow the semicolon ";" and shouldn't be entered.
  645.  
  646. cd\mega                                               ;Change to the
  647.                                                       ;MegaMail directory
  648.  
  649. if exist c:\xfer\kadet.dl megaread /IMPORT KADET      ;Check if there is a
  650.                                                       ;kadet.dl mail packet.
  651.                                                       ;If yes, import it.
  652.  
  653. megaread /EXPORT KADET                                ;Export all new mail
  654.                                                       ;to KADET BBS
  655. cd\comm\qmodem                                        ;Change to the Qmodem
  656.                                                       ;directory
  657.  
  658. qmodem /S=KADET.SCR                                   ;Start up Qmodem and
  659.                                                       ;execute the KADET script.
  660.                                                       ;KADET.SCR will call Kadet
  661.                                                       ;and open the MegaMail
  662.                                                       ;door and xfer mail and
  663.                                                       ;then exit to DOS when
  664.                                                       ;it's done.
  665.  
  666. cd\mega                                               ;Change to the
  667.                                                       ;MegaMail directory.
  668.  
  669. if exist c:\xfer\kadet.dl megaread /IMPORT KADET      ;Check if there is a
  670.                                                       ;kadet.dl mail packet.
  671.                                                       ;If yes, import it.
  672.  
  673. Thats all there is to it! If you can write a batch file to run a task,
  674. and the task exits to DOS when done, it can be automated with EVENT.
  675. After all, computers were meant to do work FOR us! Let it do it while we
  676. are not here!
  677.  
  678. Every attempt has been made to ensure bug-free operation of this
  679. program. If you have a problem or a Critter-Report, please contact me at
  680. the address below.
  681.  
  682. Ways to contact John Wagner:
  683.  
  684.         By Modem: Kadet BBS, Camden NY. (315)245-3815,(DS)8N1.
  685.                   Leave a message in Conference 0 and I'll get back
  686.                   to you within 24-48 hours.
  687.  
  688.         US MAIL:  John Wagner
  689.                   RR1 157 Box M
  690.                   Taberg, NY 13471
  691.  
  692.           EVENT(C). John Wagner 1990,91. All rights reserved
  693.